home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ifl / iflGIF.z / iflGIF
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiiffffllllGGGGIIIIFFFF((((3333))))         IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll          iiiiffffllllGGGGIIIIFFFF((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiiffffllllGGGGIIIIFFFF - GIF format image file
  10.  
  11.  
  12. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  13.      #include <ifl/iflGIF.h>
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      This Image Format Library provides support to read/write image files
  18.      stored in Compuserve Graphics Image File (GIF) format.
  19.  
  20.      The default extension for image files in the GIF format is '.gif'.  When
  21.      you create a file with that extension IFL will assume you want the GIF
  22.      format, unless you override it with the iflFormat parameter.
  23.  
  24.      In addition to all the standard iflFile methods, this format supprts an
  25.      number of format specific operations via the ggggeeeettttIIIItttteeeemmmm() and sssseeeettttIIIItttteeeemmmm()
  26.      methods.  The tag values supported by these methods are enumerated in the
  27.      following sections.
  28.  
  29.  
  30. TTTTAAAAGGGG VVVVAAAALLLLUUUUEEEESSSS FFFFOOOORRRR GGGGEEEETTTT IIIITTTTEEEEMMMM
  31.      The following tag values are supported with ggggeeeettttIIIItttteeeemmmm():
  32.  
  33.  
  34.    iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttCCCCoooolllloooorrrr
  35.           iflStatus getItem(iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttCCCCoooolllloooorrrr,
  36.                             int* red, int* green, int* blue)
  37.  
  38.  
  39.      If the GIF image being read has a transparent pixel i.e. it is intended
  40.      that a single index value be treated as a transparent pixel, then the
  41.      corresponding r,g,b values in the images colormap for that transparent
  42.      index is returned in _r_e_d, _g_r_e_e_n and _b_l_u_e. If there is no transparent
  43.      pixel then _r_e_d, _g_r_e_e_n and _b_l_u_e will be returned as -1.
  44.  
  45.  
  46.    iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttIIIInnnnddddeeeexxxx
  47.           iflStatus getItem(iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttCCCCoooolllloooorrrr, int* index)
  48.  
  49.  
  50.      If the GIF image being read has a transparent pixel i.e. it is intended
  51.      that a single index value be treated as a transparent pixel, then the
  52.      value of that transparent index is returned in _i_n_d_e_x. If there is no
  53.      transparent pixel then _i_n_d_e_x will be returned as -1.
  54.  
  55.  
  56.    iiiiffffllllGGGGIIIIFFFFiiiinnnntttteeeerrrrllllaaaacccceeee
  57.           iflStatus getItem(iiiiffffllllGGGGIIIIFFFFiiiinnnntttteeeerrrrllllaaaacccceeee, int* interlaced)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffllllGGGGIIIIFFFF((((3333))))         IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll          iiiiffffllllGGGGIIIIFFFF((((3333))))
  71.  
  72.  
  73.  
  74.      If the GIF image being read is interlaced then TRUE will be returned in
  75.      _i_n_t_e_r_l_a_c_e_d, otherwise FALSE will be returned.
  76.  
  77.  
  78.    iiiiffffllllGGGGIIIIFFFFddddeeeellllaaaayyyyTTTTiiiimmmmeeee
  79.           iflStatus getItem(iiiiffffllllGGGGIIIIFFFFddddeeeellllaaaayyyyTTTTiiiimmmmeeee, int* delayTime)
  80.  
  81.  
  82.      Returns the delay time for the current image in 1/100ths of a second or
  83.      zero if no delay is specified.
  84.  
  85.  
  86. TTTTAAAAGGGG VVVVAAAALLLLUUUUEEEESSSS FFFFOOOORRRR SSSSEEEETTTT IIIITTTTEEEEMMMM
  87.      The following tag values are supported with sssseeeettttIIIItttteeeemmmm():
  88.  
  89.  
  90.    iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttIIIInnnnddddeeeexxxx
  91.           iflStatus setItem(iiiiffffllllGGGGIIIIFFFFttttrrrraaaannnnssssppppaaaarrrreeeennnnttttCCCCoooolllloooorrrr, int index)
  92.  
  93.  
  94.      Set the index value of the image's transparent pixel to _i_n_d_e_x.
  95.  
  96.  
  97.    iiiiffffllllGGGGIIIIFFFFiiiinnnntttteeeerrrrllllaaaacccceeee
  98.           iflStatus setItem(iiiiffffllllGGGGIIIIFFFFiiiinnnntttteeeerrrrllllaaaacccceeee, int interlaced)
  99.  
  100.  
  101.      If _i_n_t_e_r_l_a_c_e_d = TRUE, then the GIF image produced will be interlaced;
  102.      otherwise not.
  103.  
  104.  
  105.    iiiiffffllllGGGGIIIIFFFFddddeeeellllaaaayyyyTTTTiiiimmmmeeee
  106.           iflStatus setItem(iiiiffffllllGGGGIIIIFFFFddddeeeellllaaaayyyyTTTTiiiimmmmeeee, int delayTime)
  107.  
  108.  
  109.      Sets the delay time for the current image in 1/100ths of a second.
  110.  
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      iflFile, ilFileImg
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.